Skip to content

fix(docs): delete the os studio CLI reference section - #231

Merged
os-zhuang merged 1 commit into
mainfrom
claude/issue-150-delete-os-studio-section
Aug 29, 2026
Merged

fix(docs): delete the os studio CLI reference section#231
os-zhuang merged 1 commit into
mainfrom
claude/issue-150-delete-os-studio-section

Conversation

@os-zhuang

Copy link
Copy Markdown
Contributor

Fixes #150

What

Deletes the ### \os studio` — dev server with the UI enabled section (content/docs/reference/cli.mdx:74-77, four lines: heading, blank, the single sentence, blank). Nothing else in the file changes — line 70's stale # port 3002 by default` comment is left untouched; it belongs to
#229, filed separately.

Why deletion, not correction

Triage adjudicated this on 2026-08-23 and it is not re-litigable: delete,
do not replace with corrected instructions. os dev is documented
directly above the deleted section, and the glossary already carries the
/_console/studio route, so a correction would only duplicate content
that already exists elsewhere.

Premise re-verified at implementation time

The dispatching card measured "no studio command" on objectstack at
a sha that was already stale by dispatch time. Re-verified just now on
current objectstack origin/main (e452ad5):

  • packages/cli/src/commands/ (via git ls-tree) has no studio.ts /
    studio/ entry.
  • Case-insensitive git grep -il studio under that directory hits only
    i18n/extract.ts, lint.ts, a migrate integration test, and a serve
    test — never a command definition. Control probe: the same grep style
    does find dev.ts under that directory, so the pattern is not
    silently matching nothing.
  • packages/cli/package.json's oclif.commands still uses
    "strategy": "pattern" against ./dist/commands with no alias map,
    so the shipped command set is exactly the files on disk — confirmed
    unchanged from the dispatching card's measurement.

os studio still does not exist. The deletion stands.

Blast radius

git grep 'reference/cli#' across content/docs returns zero anchor
links into any section of this file (control-probed: plain
/docs/reference/cli page links do exist in the corpus, e.g.
build/ai-builder.mdx, so the zero is a real absence and not a dead
probe). No other mention of "os studio" exists anywhere under
content/docs.

Out of scope (left alone on purpose)

Verification

Run from the repo root, on worktree objectos-issue-150 at commit
a1fdc91:

  • pnpm turbo run build --forceTasks: 1 successful, 1 total.
  • pnpm turbo run test --forceTasks: 1 successful, 1 total; the
    check-locale-surface.mjs self-tests inside it all pass.
  • node .github/scripts/check-locale-surface.mjs (run directly, from
    repo root, after the build above) — verdict line: "every advertised
    URL has a source file and every source file is advertised; both
    llms bodies carry every en-only page title and none from the other
    locales; and no page slug in the content tree contains a dot"
    . This
    is the gate that would notice if deleting a heading moved the
    advertised llms.txt / llms-full.txt surface — it does not, since
    those track page titles, not sub-headings.

git diff --stat: content/docs/reference/cli.mdx | 4 ----, one file,
four deletions, nothing else.


Generated by Claude Code

`os studio` is not a shipped command — the CLI's oclif config uses the
pattern strategy against packages/cli/src/commands with no alias map,
and no studio command file exists there. A reader following the CLI
reference would type `os studio` and get an oclif "command not found".

`os dev` is documented directly above and the glossary already carries
the real route (`os dev` / `os serve`, then /_console/studio in the
browser), so the section is deleted rather than corrected — triage's
adjudicated branch.

Fixes #150

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_016TUrhcggSFrYctvp5dsV1A
@os-zhuang
os-zhuang marked this pull request as ready for review August 29, 2026 13:55
@os-zhuang
os-zhuang merged commit c1f6e70 into main Aug 29, 2026
3 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

reference/cli.mdx:74 documents an os studio command the CLI does not ship

2 participants